home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / extra / conv21b.zip / CONV.DOC < prev    next >
Text File  |  1995-11-19  |  11KB  |  260 lines
  1.                             
  2.                             
  3.                             Convert It!
  4.                             Version 1.0k
  5.                            Copyright 1995 
  6.                                  by
  7.                           Don McNiel, Author
  8.  
  9.  
  10. What is it?
  11. -----------
  12. Convert it is a file conversion utility! It may be used to process
  13. a single file, multiple files using DOS wildcards, or used to 
  14. process inbound TIC files.
  15.  
  16. Features
  17. --------
  18.    - Detects file types by signature!
  19.    - Converts most archive type to RAR, ZIP, ARJ, or LZH!
  20.    - Adds a comment file if desired!
  21.    - Tottaly configurable!
  22.    - Can be used with any existing TIC program as it is called
  23.      before hand!
  24.    - Convert It! will maintain the nameing structure for inbound
  25.      FIDO style mail bundles as well as nodelist, and nodediffs!
  26.  
  27. Warranty 
  28. --------
  29. Convert It! has no known bugs. But to cover my butt, it is only 
  30. guaranteed to take up storage space on any type of storage media! 
  31. It has been thoroughly tested by a select Beta team and myself
  32. quite extensively to ensure proper operation.
  33.  
  34. Special Note.
  35. -------------
  36. I'm a programmer, not a novelist. I have tried to make this document
  37. as complete as possible. If something is unclear to you, contact me
  38. and I will try to explain it better.  I also try to fix reported bugs 
  39. within 48 hours if I can duplicate the problem or receive detailed
  40. information on your problems.  Same goes for additions, if there is
  41. something I can add to make my utilities easier/more convenient to 
  42. use, speak up! Any problem archives should be sent to me so I can create 
  43. a work around for that problem in the future.
  44.  
  45. How to install it
  46. -----------------
  47. 1. Unzip it into it's own directory.
  48.  
  49. 2. Make sure you have a line in your AUTOEXEC.BAT file as follows :
  50.     SET COMSPEC=C:\COMMAND.COM
  51.    This should specify where Convert It! can find your COMMAND.COM file.
  52.  
  53. 3. Run VCONFIG.EXE
  54.       - Configure BBS Information.
  55.       - Configure Archive Paths/Filenames.
  56.       - Configure Mailer Paths.
  57.       - Configure Preferences.
  58.  
  59. 4. That's it! Now read on to discover what Convert It! can do 4 U!
  60.  
  61. Command line switches.
  62. ----------------------
  63. Here are the functions of the various command line options.
  64. See the quick start menu to see how these are used.
  65.    
  66.    /K    - Convert It! will not delete the original archive after
  67.            conversion. This switch may be used when converting
  68.            archives from the dos prompt. This would not be recommended
  69.            when doing inbound TIC files, especially if you have a
  70.            Planet connect feed. ;)
  71.    /ID   - Convert It! will determine the file type when this switch
  72.            is used.
  73.            (A later version will produce exit error levels that will 
  74.            correspond to the supported file types for use with other 
  75.            utilities.)
  76.    /TIC  - Convert It! will process any TIC files found in the directories
  77.            as configured in VCONFIG.
  78.    /PC   - Convert It! will process the Planet Connect ALLTICS.xxx file.
  79.            There is an option in VCONFIG to save this file after
  80.            processing if so desired.
  81.    /CRC- - Tells Convert It! not to check the validity of the file
  82.            CRC as contained in the TIC file.  
  83.            [This may cause Convert It! to hang on certain LHA 
  84.            archives that have CRC errors. This is due to a 
  85.            Y/N prompting.]
  86.    /RAR  - Convert It! will convert found archives to a RAR archive.
  87.    /ZIP  - Convert It! will convert found archives to a ZIP archive.
  88.    /ARJ  - Convert It! will convert found archives to a ARJ archive.
  89.    /LHA  - Convert It! will convert found archives to a LZH archive.
  90.  
  91. Other Programs needed by Convert It!
  92. ------------------------------------
  93. Below is a list of Archive files needed for Convert It! to function 
  94. properly. These files must be located in your DOS path. If these files
  95. are not found, Convert It! will skip those archives.
  96.  
  97. PKZIP.EXE   - Needed to create ZIP archives.
  98. PKUNZIP.EXE - Needed to UnZip ZIP archives.
  99. ARJ.EXE     - Needed to proccess ARJ archives.
  100. LHA.EXE     - Needed to process LZH and LHA archives.
  101. PKUNPAK.EXE - Needed to unarchive ARC archives.
  102. RAR.EXE     - Needed to process RAR archives.
  103.  
  104. Quick Start, Most common combinations Explained.
  105. ------------------------------------------------
  106. In the examples below, /RAR, /ZIP, /ARJ, and /LHA can be freely
  107. substituted for the same to acomadate your preferences.
  108.  
  109. 1)  To convert a single file :
  110.       CONV FILE.ZIP /RAR
  111.     This would convert FILE.ZIP to FILE.RAR. Adding the /K switch
  112.     after /RAR would cause FILE.ZIP not to be deleted after processing.
  113.  
  114. 2)  To convert files in a subdirectory :
  115.       CONV *.ZIP /ARJ
  116.     This would convert any ZIP archives found to the type ARJ.
  117.     (A *.* would convert any archives to type ARJ.) Add the /K switch
  118.     to keep original archives.
  119.  
  120. 3)  To Identify an file type :
  121.       CONV FILE.EXT /ID
  122.     This will determine the file type and write it to the screen.
  123.     Recognized file types are listed in appendix A. 
  124.  
  125. 4)  To convert TIC files and their archives :
  126.       CONV /TIC /ZIP
  127.     This will convert TIC's found in the inbound directories to the
  128.     type ZIP. This will also update the *.TIC file with the converted
  129.     filename and the new file CRC.
  130.  
  131. 5)  To convert TIC files and proccess Planet Connects ALLTICS.* file :
  132.       CONV /TIC /ZIP /PC
  133.     This will do the same as example #4, but in addition, Convert It!  
  134.     will PKUNZIP the ALLTICS.xxx file in the Satellite directory and
  135.     continue to process the inbound TIC files.
  136.  
  137.  
  138. Files included in archive
  139. --------------------------
  140. VCONFIG.EXE   - This is the setup program for Convert It!. This
  141.                 is where you define your inbound TIC paths, BBS
  142.                 information, and a few other options.
  143.  
  144. CONV.EXE      - This is the Convert It! utility executable.
  145.  
  146. CONV.CFG      - This file is created by VCONFIG.EXE and must be in
  147.                 the same directory as CONV.EXE.
  148.  
  149. CONV.DOC      - This document.
  150.  
  151. CONV.LOG      - This is the log file created by CONV.EXE and contains 
  152.                 semi-detailed information on everything Convert It! 
  153.                 has done. Any entries that begin with a ! need
  154.                 immediate attention!
  155.  
  156. CONV.ERR      - This is the error file created by CONV.EXE if an
  157.                 error should occur. 
  158.  
  159. CONV.CMT      - This is the file added to archives. This should be a
  160.                 regular ascii file telling others about your system.
  161.  
  162. ADDNAMES.LST  - This file is optional. If this file is found in the
  163.                 Convert It! directory, a filename is picked from this
  164.                 file at random and Convert It! will add CONV.CMT to
  165.                 the archive being converted under the name extracted.
  166.                 This file should contain a list of valid DOS filenames.
  167.  
  168. DELNAMES.LST  - This file is optional. If this file is found in the
  169.                 Convert It! directory, filenames from this file are
  170.                 deleted from the archive being processed.  Use this
  171.                 with Caution!
  172.                 This file should contain a list of valid DOS Filenames.
  173.  
  174. NOCONV.LST    - This file is optional. If this file is found in the
  175.                 Convert It! directory, Convert It! will scan this file
  176.                 to see if *ANY PART* of the contents in this file is 
  177.                 contained in the filename to be converted.  If .GIF is 
  178.                 listed in this file, GIF files will not be converted.
  179.                 This is also usefull for .NO and .NA Fido Echolist files.
  180.  
  181. WHATSNEW.DOC  - This is a text file containing Convert It!'s history.
  182.  
  183. REGISTER.DOC  - This is a text file on how to register my programs via
  184.                 snail mail or any other means.
  185.  
  186. B4UASK.DOC    - This file contains helpfull hints on common problems.
  187.                 Check this file if you have any problems.
  188.  
  189. BUGRPT.FRM    - If you have any problems with Convert It!, and you have
  190.                 already checked the B4UASK.DOC, fill this out and send
  191.                 it to me. A simple 'It don't work' doesn't tell me
  192.                 anything and the problem will continue. Be sure to 
  193.                 include your CONV.LOG, CONV.ERR, and CONV.CFG files 
  194.                 as well.
  195.  
  196. Registration / Evaluation Information.
  197. --------------------------------------
  198.  - The registration for Convert It! is $15. See REGISTER.DOC for more
  199.    information!
  200.  - All future upgrades for my programs are free.
  201.  - Convert It! may be evaluated for 30 days. After that period it
  202.    must be registered to continue using this program. This is a very
  203.    generous evaluation period. During this evaluation period, the
  204.    program will function exactly like the registered version!
  205.  
  206. Support / Suggestions
  207. ---------------------
  208. I can be reached at the following locations including the following
  209. FIDO message area(s) : WILDCAT, WC_CHAT, PASCAL, and the Internet.
  210.  
  211. Look for more of my programs on my BBS!
  212.  
  213. Don McNiel
  214. Rad Shak! BBS
  215. FIDO : 1:291/39
  216. Internet : support@radshak.com
  217. Node 1 (316)524-8707
  218. Node 2 (316)524-0405
  219.  
  220. The latest version can be FREQ'd from  1:291/39 with the name of
  221.  
  222. VIEWIT - ViewIt! Latest version!
  223. REMDIR - Remote Directory latest version!
  224. CONVIT - Convert It! Latest Version!
  225.  
  226. Appendix A - File Types Currently Recognized.
  227. ---------------------------------------------
  228. The following file types are recognized by Convert It! These
  229. file types are determined by signature, not extension detection,
  230. and will determine the file type 99.99% of the time. The only type is
  231. not 99.99% reliable is ARC type files, ARC files have one byte for a 
  232. signature and care should be taken when converting this type.
  233.  
  234. !UNKNOWN  - Not a recognized file type.
  235. !BBS      - @CODE@ graphic display file.
  236. !ANSI     - ANSI graphic display file.
  237. !TEXT     - Text file.
  238. !GIF      - GIF graphic file.
  239. !JPG 1    - Older JPG graphic file.
  240. !JPG 2    - Newer JPG graphic file.
  241. !FLI      - FLI type animated graphic file.
  242. !FLC      - FLC type animated graphic file.
  243. !EXE NEW  - Newer type DOS executable file.
  244. !EXE OLD  - Older type DOS executable file.
  245. !EXE WIN  - Windows or OS/2 executable file.
  246. !COM NEW  - Newer dos executable.
  247. !COM OLD  - Older dos executable.
  248. RAR       - RAR compressed archive.
  249. ZIP       - ZIP compressed archive.
  250. LZH       - LZH or LZW compressed archive.
  251. ARC       - ARC compressed archive.
  252.  
  253.         (* Windows is copyrighted by Microsoft.
  254.            GIF is copyrighted by Compuserve.
  255.            RAR is copyrighted by it's author.
  256.            ZIP is copyrighted by it's author.
  257.            LZH is copyrighted by it's author.
  258.            ARC is copyrighted by it's author. *)
  259.  
  260.